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1.  VU  PROGRAM 


The  VU  program  provides  interactive  access  to  either  the  DASA  created  data  files  or  a 
database  of  the  processed  data. 

The  user  must  communicate  to  the  VU  program  the  type  of  devices  that  are  in  use.  This  is 
done  through  a  file  named  VU.CNF  which  the  VU  program  reads  during  initialization.  Tlie  format 
of  the  file  is  as  follows: 


Line 


No. 

Descriotion 

Format 

Example 

1 

Device  driver  for  graphics  card 

(A15) 

HALOIBME.DEV 

2 

Device  driver  for  printer 

(A15) 

HALOEPSN.PRN 

3 

Specify  font 

(A15) 

HALO104.FNT 

4 

Graphics  mode  (12  format) 

(12) 

^4 

5 

Color  choices 

(A15) 

DEFAULT 

If  any  value  other  than  default  the  user 
must  follow  with  a  line  of  color  choices. 
The  format  is  (615)  and  the  colors  indi¬ 
cated  specify  foreground,  background, 
viewport  border,  and  text  colors. 

Default  values  are 
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IFGD  =  0  (black) 
IBGD  =  7  (grey) 
ITCL  =  0  (black) 
IHCL  =  12  (red) 
INCR  =  9  (cyan) 
IBDR  =  1  (blue) 


foreground 

background 

text 

wait  message 
heading  text 
viewport  border 


Interrupt  number  and  locater 


(12,  A15)  ^'KEYBOARD 


The  user  must  be  sure  the  device  drivers  specified  have  been  obtained  from  the  HALO 
diskettes. 

The  device  driver  required  to  use  the  keyboard  as  a  locater/cursor  must  be  executed  before 
running  the  VU  program.  The  command  is  HALOKBDI.COM  -14.  The  file  RUNVU.BAT  can  be 
executed  to  load  the  device  driver  and  run  VU. 
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The  program  is  executed  with  the  command  VU. 

Each  level  of  the  program  is  controlled  by  a  menu  which  appears  on  the  top  three  lines  of  the 
screen.  A  tree  representation  of  the  program  flow  is  shown  as  Figure  1. 

The  first  line  on  the  screen  describes  the  current  function.  Line  2  displays  the  various  choices 
available  with  this  function.  As  the  user  traverses  the  choices  with  the  left  and  right  arrows,  the 
description  of  the  current  choice  appears  on  line  3.  A  choice  is  made  by  either  pressing  the  key 
which  corresponds  to  the  capitalized  letter  of  choice,  or  hitting  "return"  when  the  choice  is 
highlighted.  The  escape  key  can  be  used  to  return  to  last  level  of  menu  at  any  time. 

1.1  VUMENU 

The  first  screen  which  appears  offers  the  following  choices. 


WRAIR  Experimental  Data  Reduction 


Files 


Calculate 


Access  to  Disc  Files 


The  choices  are  described  below. 


1.2  FILES 

The  Files  option  allows  the  user  to  access  disk  files.  When  this  is  chosen  the  following  menu 
appears. 


Specify  File  Type 


DASA 


dataBase 


dlRecto 


File  is  in  DASA  format 


1.2.1  The  DASA  Option 

The  DASA  option  will  request  the  user  to  provide  the  path  name  under  which  the 
EXPERIM.DAS  directory  will  be  found.  The  path  given  will  be  assumed  to  have  the  standard 
structure  for  files  as  described  in  DASA  Tech  Note  #8,  Application  Note  #3061,  13  Nov  1985. 
This  directory  will  be  read  and  the  files  in  the  first  subdirectory  will  be  listed.  The  user  may  choose 
a  RAW  data  file  to  be  processed  by  moving  the  highlighted  field  with  the  up  and  down  arrows  and, 
striking  return  at  the  appropriate  name.  The  options  of  moving  to  the  next  subdirectory  or 
terminating  the  file  read  process  are  also  available. 
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vu 


Files 


■  Calculate 


"Average 

"Time 

■  Impulse 

■  Calibration 


Plot 


Figure  1.  Tree  representation  of  VU  Program. 


I 
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1.2.2  The  dataBase  Option 


If  the  dataBase  option  is  chosen,  the  next  menu  will  offer  the  choice  of  reading,  writing  or 
specifying  the  name  of  the  database  file. 


File  Manipulation 


Read 


Read  File  from  Disc 


Write 


Name 


Quit 


When  the  Read  option  is  chosen,  the  user  is  presented  with  a  list  of  the  shots  which  are 
available  in  the  database.  When  a  shot  is  chosen,  the  subjects  which  pertain  to  that  shot  are  listed. 
A  shot  or  subject  is  chosen  using  the  up  or  down  arrows,  and  striking  return  when  the  desired  file 
is  highlighted. 

The  Write  option  will  output  the  data  currently  in  memory  to  the  selected  database.  The  user 
will  be  prompted  for  data  fields  required  by  the  database. 

General  information  required  for  each  shot  is  listed  below. 


Prompt 

Type  of  explosive 
Weight  of  explosive 
Height  of  blast 


Sample  Response 
C-4  sphere 


3.01b 
4.0  ft 


In  addition,  each  location  will  request  the  following  data. 


Prompt 

Location  description 
Distance 


Sample  Response 
South  Freefield 
16.2  ft 


When  the  database  is  initialized  the  user  is  allowed  to  define  up  to  five  additional  fields  which 
are  location  dependent.  Input  for  these  fields  will  also  be  solicited  at  this  time.  Section  2  describes 
initialization  of  the  database.  The  information  provided  in  these  fields  will  be  used  to  search  the 
database.  Therefore  a  standard  set  of  responses  should  be  established  before  entering  data  into 
the  database. 

The  Name  option  is  available  to  select  a  new  database  previous  to  a  Read  or  Write  command. 

1.2.3  The  List  Option 

The  List  option  gives  a  list  of  files  which  exist  on  a  user  specified  directory. 

1.2.4  The  dlRectory  Option 


The  diRectory  option  allows  the  user  to  specify  a  path  name  for  DASA  input  files. 


1.3  CALCULATE 

The  Calculate  option  allows  manipulation  of  the  raw  data.  The  following  set  of  options  will  be 
offered. 


Calculation  of  Data 


Time 


Average 


Imoulse 


Calibration 


Time  Average  data 


1.3.1  Average 

Average  will  select  the  number  of  raw  data  points  to  be  averaged  and  plotted  and  saved  as 
one  data  point. 

1.3.2  Time 

Time  will  choose  a  time  frame  of  the  raw  data  to  be  displayed  and  saved. 

1.3.3  Impulse 

Impulse  will  calculate  and  display  the  impulse  and  duration  data. 

1.3.4  Calibration 

Calibration  will  prompt  the  user  to  input  the  factor  to  be  used  to  convert  the  data  from  volts 
to  psi  or  G. 

1.4  PLOT 

The  Plot  option  allows  the  user  to  plot  current  data  to  screen  or  printer.  The  data  may  also  be 
integrated.  Options  to  alter  scales  and  labels  are  also  available. 


Plot  Data 

1  Draw  1 

View/Change  Print  Integrate  Cursor 

Q 

uit 

Plot  current  data  ^ 

1.4.1  The  Draw  Option 

The  DRAW  option  displays  the  data  currently  in  memory  on  the  screen. 
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1.4.2  The  View/Chan 


The  View/Change  option  offers  the  menu  shown  below  with  plotted  data. 


View/Change  Scaling  and  Labeling 


•.4  11.4 

TIMS  <MS»o> 


te.a 


The  choices  allow  the  user  to  change  plot  scaling  and  labeling. 

When  Plot  is  chosen  the  menu  shown  below  is  displayed.  This  allows  the  user  to  change  the 
parameters  for  the  plot.  The  minimum  and  maximum  values  for  either  the  time  or  Y  axis  scales. 
(Changes  to  Y  values  do  not  affect  plots  of  the  integral.) 

The  default  values  are  the  calculated  minimum  and  maximum  values  of  the  data. 


min 


Y  max 


YDIv 


The  Integral  option  provides  the  same  capability  for  the  plots  of  integrals.  A  sample  screen 
and  integral  plot  are  shown  below. 
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The  Label  option  allows  the  user  to  override  the  default  values  for  the  title  or  the  x  or  y  axis 
labels.  Default  labels  for  the  time  axis  will  be  TIME  (msec).  The  y  axis  will  be  Pressure  (kPa)  or  V. 
The  menu  for  the  Label  changes  is  shown  below. 


1.4.3  The  Print  Option 

The  Print  option  puts  the  current  plot  on  the  printer. 

1.4.4  Integrate 

Integrate  will  produce  a  plot  of  the  integrated  data. 

1.4.5  The  Cursor  Option 

The  Cursor  option  provides  a  cross  hair  cursor.  The  cursor  position  is  controlled  by  the  left 
and  right  arrows  on  the  number  pad.  The  values  of  the  time  and  Y  axis  at  the  cursor  position  are 
displayed  on  the  screen.  The  cursor  function  is  terminated  with  the  escape  (ESC)  key. 

1.5  EXIT 

This  option  terminates  the  VU  program. 
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2.  DATABASE  PROGRAMS 


The  program  DBINTT  is  used  to  initialize  a  database.  When  run  the  header  fields  are  created. 
The  user  is  prompted  to  define  up  to  5  fields  for  the  database.  Each  field  description  consists  of  20 
characters.  When  data  is  put  into  the  database  the  user  will  be  required  to  supply  information  for 
each  of  these  fields  for  each  shot  location. 

The  program  DBLIST  will  provide  a  listing  of  data  currently  in  a  selected  database. 


3.  DESCRIPTION  OF  THE  DATABASE  FILE 


The  database  file  consists  of  10  header  records  and  up  to  3200  data  records.  Each  data  record 
is  keyed  by  the  shot  number,  device  number  and  chaimel  number. 

The  first  header  record  contains  the  following  information. 


NUMREC 

MAXREC 

MAXCHL 

MAXDEV 

MAXSHT 

EXPLSV(MAXSHT) 

CWGHT(MAXSHT) 

FNAME(MAXSHT) 

HOB(MAXSHT) 


Number  of  records  in  database. 

Maximum  number  of  records  in  database. 

Maximum  number  of  channels  =  8. 

Maximum  number  of  devices  =  4. 

Maximum  number  of  shots  =  100. 

12  character  descriptor  of  explosive  type  for  each  shot. 
8  character  description  of  weight  of  explosive. 

12  character  directory  name  of  shot. 

8  character  description  of  height  of  blast  for  each  shot. 


Header  record  2  contains  the  following  information. 

NREC(4,8, 100)  Record  number  for  each  device,  channel,  shot. 

DESC(5)  20  character  description  for  each  of  5  user  defined  fields. 

Header  records  3-10  are  available  for  future  use. 


Each  data  record  consists  of  the  following  fields. 


No.Of 


Name 

Description 

Field 

Bytes 

SUBJCT 

Name  of  subject  (RAW  fllename) 

A12 

12 

LOG 

Description  of  location 

A44 

44 

NPTS 

Number  of  data  points 

12 

2 

TSTART 

Start  time  (msec) 

F 

4 

DT 

Time  step  (msec) 

F 

4 

TUNTTS 

Time  units 

AlO 

10 

10 


Name 


Description 


No.Of 
Field  Bytes 


YUNTTS 

y  axis  units 

AlO 

10 

VMIN 

Minimum  y  axis  value 

F 

4 

VMAX 

Maximum  y  axis  value 

F 

4 

NDEV 

Device  number 

12 

2 

NCHL 

Channel  number 

12 

2 

DIST 

Not  used 

F 

4 

IWFR 

Logical  device 

12 

2 

TIME 

Time  of  shot 

A12 

12 

DATE 

Date  of  shot 

A12 

12 

CALIB 

Conversion  to  psi  or  G 

F 

4 

DURAT 

Duration  of  impulse  (msec) 

F 

4 

AIMPLS 

Impulse  (kPa  or  G) 

F 

4 

NODIR 

Index  to  FNAME 

12 

2 

TDIV 

Number  of  division  times 

F 

4 

YDIV 

Number  of  divisions  y 

F 

4 

ID 

Tide 

A80 

80 

FIELD(S) 

User  supplied  fields 

A20 

100 

XLAB 

X  label  for  graph 

A40 

40 

YLAB 

y  label  for  graph 

A40 

40 

VALUE(3000) 

Data  points 

F 

12,000 
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